> ## Documentation Index
> Fetch the complete documentation index at: https://sequence-0fb8d9e6-api_docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Clients

In the context of SequenceEthereum, a `Client` is defined by the [`IEthClient` interface](https://github.com/0xsequence/sequence-unity/blob/master/Assets/SequenceSDK/Ethereum/Provider/IEthClient.cs).

Creating a client requires a `Chain`. This will use our highly available and responsive Node Gateway service for your RPC requests; accessed using the API key from the Builder you've provided in your `SequenceConfig` scriptable object. If you prefer to use your own RPC URL, you can create a `SequenceEthClient` using a URL string as a parameter instead.

You can create a client using this snippet:

```csharp theme={null}
IEthClient client = new SequenceEthClient(Chain.Polygon);
```

## Methods

As your connection point to Ethereum nodes, there are a number of methods that can be performed by a client, these can be found in the `IEthClient` interface and are implemented by `SequenceEthClient`.

Note: with the exception of BalanceAt (potentially), most users will not need to make use of these methods, but we have included them in our documentation for completeness.

### BalanceAt

Used to get the gas currency balance of a given wallet at a given blockNumber (in hexadecimal format provided as a string)

```csharp theme={null}
BigIntegar balance = await client.BalanceAt(wallet.GetAddress()); // By default, if no blockNumber string is provided, check the latest block
BigIntegar balance = await client.BalanceAt(wallet.GetAddress(), blockNumber);
```

Note: there are two special values for blockNumber. "earliest" will get the balance at the earliest block on the chain. "latest" will get the balance at the latest block on the chain and is the default parameter when none is provided. Otherwise, you'll want to provide the blockNumber string in hexadecimal format.

<Warning><b><u>Unless you <i>really</i> want to get into the weeds with how things work, it is HIGHLY recommended to move on to the next page of the documentation at this point</u></b></Warning>

### BlockByNumber

Used to get the `Block` with a specific block number.

```csharp theme={null}
Block block = await client.BlockByNumber(blockNumber);
```

Note: as above, blockNumber should be in hexadecimal format or special values "ealiest" and "latest"

### BlockByHash

Used to get the `Block` by a specified block hash (string)

```csharp theme={null}
Block block = await client.BlockByHash(blockHash);
```

### BlockNumber

Used to get the most recent block number in hexadecimal format

```csharp theme={null}
string blockNumber = await client.BlockNumber();
```

### BlockRange

Used to get a `List<Block>` from the blocks in a range specified by blockNumbers

```csharp theme={null}
List<Block> blockRange = await client.BlockRange(startingBlockNumber, endingBlockNumber);
```

Note: as above, blockNumber should be in hexadecimal format or special values "ealiest" and "latest"

### ChainID

Used to get the chain id in hexadecimal format for the chain the client is connected to

```csharp theme={null}
string chainId = await client.ChainID();
```

### CodeAt

Used to get the bytecode for a smart contract at a given address in hexadecimal format at a specified blockNumber

```csharp theme={null}
string code = await client.CodeAt(contractAddress, blockNumber);
```

Note: as above, blockNumber should be in hexadecimal format or special values "ealiest" and "latest"

### EstimateGas

Given a `TransactionCall` estimate the amount of gas required for the transaction

```csharp theme={null}
BigIntegar gas = await client.EstimateGas(transactionCall);
```

### FeeHistory

Get a `FeeHistoryResult` for gas fees paid blockCount blocks since newestBlock (blockNumber)

```csharp theme={null}
FeeHistoryResult feeHistory = await client.FeeHistory(blockCount, newestBlock, new int[] { });
```

Note: as above, blockNumber should be in hexadecimal format or special values "ealiest" and "latest"

### NetworkId

Used to get the chain id in integer format (as string) for the chain the client is connected to

```csharp theme={null}
string networkId = await client.NetworkId();
```

### NonceAt

Used to get the recommended nonce for a given `Address` at a given blockNumber (defaults to "latest")

```csharp theme={null}
BigInteger nonce = await client.NonceAt(wallet.GetAddress()); // Nonce at latest
BigIntegar nonce = await client.NonceAt(wallet.GetAddress(), blockNumber);
```

Note: as above, blockNumber should be in hexadecimal format or special values "ealiest" and "latest"

### SendRawTransaction

Given a signed transaction string, submit the transaction to the network and return a transaction hash

```csharp theme={null}
string transactionHash = await client.SendRawTransaction(signedTransactionString);
```

### SuggestGasPrice

Used to get a suggested gas price

```csharp theme={null}
BigIntegar gasPrice = await client.SuggestGasPrice();
```

### SuggestGasTipCap

Used to get the max suggested priority fee for gas

```csharp theme={null}
BigIntegar gasTipCap = await client.SuggestGasTipCap();
```

### TransactionByHash

Used to get a `Transaction` by transaction hash

```csharp theme={null}
Transaction transaction = await client.TransactionByHash(transactionHash);
```

### TransactionCount

Used to get the number of transactions in a block by block hash

```csharp theme={null}
BigIntegar transactionCount = await client.TransactionCount(blockHash);
```

### WaitForTransactionReceipt

Provide a transaction hash in order to wait for and return the `TransactionReceipt`

```csharp theme={null}
TransactionReceipt receipt = await client.WaitForTransactionReceipt(transactionHash);
```